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International Pricing Engine 
GETSER VICE WITH PRICING 


CALCUL ATESERVIC EPRICE 


.NET Software Development Kit Overview 


This software development kit (SDK) is intended to provide software and Internet developers with the 
ability to integrate postage rate information into programs and/or web sites. 


Licenses and Liability 


The information and components contained within this SDK may be distributed only to individuals who 
have signed the USPS User License and may only be used in accordance with the terms of the USPS User 
License. The USPS assumes no liability for the incorrect implementation of this SDK once it has been 
incorporated into a client product. The USPS will supply upgrades to the data and/or the objects when 


needed, but it assumes no part in distribution of these upgrades once the engine has been integrated 
into client products. 


Purpose 
This document will explain the Domestic and International Pricing Engine .NET Interface. 


Contact Information 


For Technical Support, contact: 
Email: RCalcPEPMOSupport @ usps. gov 


For USPS Support, contact USPS: 
Email: PostalExplorer@ usps.com 
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Application Programming Interface (API) 


Overview 

The Pricing Engine is built using the Model, View, Controller (MVC) design pattern and should be used as 
a black box. All of the Pricing Engine behavior is provide by making calls to methods that are part of a 
single interface class named PostOffice. 


Working IDs 

The Pricing Engine does not enumerate the ID. This was done to allow for greater flexibility. As new 
services are added the ID of that service only needs to be known to the service itself. The user of the 
Pricing Engine should not hard code any IDsinto their application because services and IDs may change 
over time. To get the ID of a service, the developer should request the services by specifying to know 
mail properties and then use the ID of the desired service from the results returned. 


Configuration File 
To use the .NET SDK, the developer is responsible for creating a configuration file for the application; 


web.config for web applications and app.config for windows applications. These configuration files must 
include the following: 


Domestic Pricing Engine SDK 


Defines the endpoint binding for the Service Delivery Calculator (SDC) 
<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<binding name="serviceDeliveryCalculatorSoap11" 
maxReceivedMessageSize="2147483647" 
maxBufferPoolSize="2147483647" > 
<readerQuotas maxArrayLength="2147483647" 
maxStringContentLength="2147483647"/> 
<security mode="Transport"> 
<transport clientCredentialType="Certificate" /> 
</security> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors> 
<endpointBehaviors> 
<behavior name="endpointCredentialBehavior"> 
<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine" 
storeName="Root" 
x509FindType="FindByThumbprint" 
findValue="8858d68f41053dff6da7a1921c5a4a222f5536f8" /> 
</clientCredentials> 
</behavior> 
</endpointBehaviors> 
</behaviors> 
<client> 
<endpoint 
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address= 
“https://sdc1.usps.gov/sdc-services/services/serviceDeliveryCalculator” 
behaviorConfiguration="endpointCredentialBehavior" 
binding="basicHttpBinding" 
bindingConfiguration="serviceDeliveryCalculatorSoap11" 
contract="Domestic.SDC.SDC2Ref.service DeliveryCalculator" 
name="serviceDeliveryCalculatorSoap11" /> 
</client> 
</system.serviceModel> 
Note: the “endpoint address” needs to be the URL for the SDC webservice. 


Defines the database connection string 


The database versions configuration element supports the ability to reference different versions of the 
calculator. The implementation supports a capability to pre-deploy a price change and automateically 
execute it on the date defined by the “startDate” attribute. 


The startDate attribute worksin conjunction with the mail properties shippingDate to delineate the 
database to use. The calculator will default to Now, today’s date, in the absence of a user specified 
shipping date. 


The connection version is used to specify the connection string in the connectionStrings XML node. You 
can see the version in the connection name, e.g. Domestic.Business.R1701. The engine will determine 
what connection version to use based upon the start date. Then it will iterate over the connection 
names to fine that version. 


The connection version “NAN” is the default connection string. It will be used in the absence of a data 
source version. 


<datasourceVersions> 
<add startDate="1/22/2017" connectionVersion="R1701" /> 
<add startDate="1/17/2018" connectionVersion="R1801" /> 
</datasourceVersions> 


<connectionStrings> 
<add 
name="Domestic.Business.NAN" 
connectionString="Data Source=SQLSERVICE; Initial Catalog=USPS_DOM_2017_01;Integrated Security=True" 
providerName="RateEngine.Data.SQLDataSource"/> 


name="Domestic.Business.R1701" 
connectionString="Data Source=SQLSERVICE;Initial Catalog=USPS_DOM_2017_01;Integrated Security=True" 
providerName="RateEngine.Data.SQLDataSource"/> 


name="Domestic.Business.R1701" 
connectionString="Data Source=SQLSERVICE;Initial Catalog=USPS_DOM_2017_01;Integrated Security=True" 
providerName="RateEngine.Data.SQLDataSource"/> 

</connectionStrings> 


name 
The Pricing Engine looks for a connection string named “Domestic. Business.<connectionVersion>”. 


connectionString 
Used to connect to the database. 
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providerName 
The Pricing Engine uses this value to know underlying data source. Currently the valid values are: 


e RateEngine.Data.SQLDataSource — Microsoft SQL Server database 
e RateEngine.Data.AccessDataSource — Microsoft Access database 


Defines the Application settings 
<appSettings> 
<add key="ServiceDeliveryCalculator Available" value="true"/> 
<add key="ServiceDeliveryCalculator.Provider" value="SDC2"/> 
<add key="ServiceDeliveryCalculator.Available.International" value="true"/> 
<add key="ServiceDeliveryCalculator.Provider.International" value="GCW"/> 
</appSettings> 


NOTE: Valid values include KPG and GCW. KPG will tell the engine to use the old Kahala interface. GCW 
will tell the engine to use the new SDC GCWrapper interface. 


International Pricing Engine SDK 


Defines the endpoint binding for the Kalaha (KPG) and the GCWrapper (GCW) 


<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala Standard version --> 
<binding name="SOAPInterfaceSoapBinding" maxReceivedMessageSize="2147483647" 
maxBufferPoolSize="2147483647" > 
<readerQuotas maxArrayLength="2147483647" 
maxStringContentLength="2 147483647" /> 
<security mode="Transport"> 
<transport clientCredentialType="Certificate" /> 
</security> 
</binding> 


<!-- Kahala GCWrapper version --> 
<binding name="GCWrapperSOAPInterfaceBinding" maxReceivedMessageSize="2147483647" 
maxBufferPoolSize="2147483647"> 
<readerQuotas maxArrayLength="2147483647" maxStringContentLength="2147483647" /> 
<security mode="Transport"> 
<transport clientCredentialType="Certificate"/> 
</security> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors> 
<endpointBehaviors> 
<!-- Kalaha Standard version --> 
<behavior name="endpointCredentialBehavior"> 
<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine" 
storeName="Root" 
x509FindType="FindByThumbprint" 
findValue=”XXXXX" /> 
</clientCredentials> 
</behavior> 


<!-- Kalaha GCW version --> 
<behavior name="endpointCredent ialBehaviorGCW"> 
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<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine" 
storeName="Root" 
x509FindType="FindByThumbprint" 
findValue="XXXXX" /> 
</clientCredentials> 
</behavior> 
</endpointBehaviors> 
</behaviors> 


<client> 

<!-- Kahala Standard version --> 

<endpoint 
address="https://Ikahala-cat.usps.com/SOAPInterfaceWebModule/services/SOAP Interface" 
behaviorConfiguration="endpointCredentialBehavior" 
binding="basicHttpBinding" 
bindingConfiguration="SOAPInterfaceSoapBinding" 
contract="International.KPG.ServiceRef.SOAPInterface" 
name="SOAPInterface" /> 


<!-- Kahala GCWrapper version --> 
<endpoint address="https://sdc1-cat.usps.gov/sdc-services/services/sdcInternationalPassthrough" 
behaviorConfiguration="endpointCredentialBehaviorGCW" 
binding="basicHttpBinding" 
bindingConfiguration="GCWrapperSOAPInterfaceBinding" 
contract="International.KPG.GCWrapper.GCWrapperSOAPInterface_SEl" 
name="GCWrapperSOAPInterface" /> 
</client> 
</system.serviceModel> 
Note: 
1. ThefindValue property of the X509Findtype is not XXXXX. We are not publishing the value. 


2. The “endpoint address” needs to be the URL for the KPG or SDC GCWrapper webservice. 


Defines the EndPoint binding for International Mail Console (aka IDG-M, UPUXIT) 
The following application configuration items must be defined to support the integration of the IMC 


with the International Pricing Engine. 


<add key ="IMC.Provider" value="SDC"/> 

<add key ="IMC.Available" value="True"/> 

<add key ="IMC.DateTimeAvailable" value ="1/24/2021"/> 

<add key ="IMC.URL" value="https://eagnmnmbd281.usps.gov:9443/idgm-reporter/supportedCountries"/> 


The important element here is the IMC.URL. The IMC.URL maintainsthe IMC endpoint. Consult with 
the SDC team for the proper endpoint address for your environment. 


Defines the database connection 
<connectionStrings> 
<add 
name="International.Business" 
connectionString="Data Source=(LOCAL); Initial Catalog=USPS_INTL_2015; Integrated 
Security=True" providerName="RateEngine. Data.SQLDataSource"/> 
</connectionStrings> 


Defines the Application settings 
<appSettings> 
<add key="ExpressMailGuaranteedWS. Enabled" value="true"/> 
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</appSettings> 


Domestic Pricing Engine Interface 
The following operations are defined for the Domestic Pricing Engine. See “Pricing Engine Design 
Model. pdf” for details. 


PostOffice Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Business 


CalculateServicePrice Method 


Description 
This method is used to calculate the total cost of a selected mail service and any selected extra services. 


Syntax 
CalculateServicePrice(in request : CalculationRequest) : CalculatedPricing 


GetExtraServicesWithPricing Method 


Description 
This method is used to geta specified list of extra service with the price of each. 


Syntax 
GetExtraServicesWithPricing(in extraServicesRequest: ExtraServicesRequest) : ExtraServicesWithPricing 


GetLocations Method 


Description 
This method is used to get locations by specifying a list of ZIP Codes. The similiar method with the 


shipping DateTime input parameter changes the behavior to produce results available as of the date 
specified. 


Syntax 
GetLocations(in zipCodes : ZipCodeCollection) : LocationCollection 


GetLocations(in zipCodes : ZipCodeCollection, in shippingDateTime : DateTime) : LocationCollection 


GetMailingRestrictions Method 


Description 
This method is used to get the mailing restrictions for a specified ZIP Code or collection of ZIP Codes. The 


similiar method with the shipping DateTime input parameter changes the behavior to produce results 
available as of the date specified. 
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Syntax 
GetMailingRestrictions(in zipCodes : ZipCodeCollection) : MailingRestrictionCollection 


GetMailingRestrictions(in zipcodes : ZipCodeCollection, in shippingDateTime : DateTime): 
MailingRestrictionCollection 


GetPriceBySKU Method 


Description 

This method is used to geta collection of Prices for a specified SKU. The requested SKU can be a full 15 
digit SKU or a partial SKU. The requested SKU can also contain wildcard characters “%”. The result 
collection will contain all prices that match the requested SKU. Each node in the collection contains the 
SKU, Price, Postage Statement Section and Postage Statement Line. 


Syntax 
GetPriceBySKU(in priceBySKURequest : SKURequest) : SKUPriceCollection 


GetServiceCommitments Method 


Description 
This method is used to get the mailing service commitments for the specified request. The caller is 
required to specify the following: 

e Origin ZIP Code 

e Destination ZIP Code 

e Shipping date/time 

e Mail shape and size 


Syntax 
GetServiceCommitments(in servicesRequest : ServicesRequest) : ServiceCommitmentCollection 


GetServiceCommitments(in servicesRequest : ServicesRequest , LocationCollection locations) : 
ServiceCommitmentCollection 


GetServiceWithPricing Method 


Description 
This method is used to get a list of mailing services with associated extra services for the specified mail 
piece attributes. 


Syntax 
GetServiceWithPricing(in request : ServiceRequest) : ServiceWithPricing 


GetServiceWithPricing(in request : ServiceRequest, in serviceContainerAttributes : 
ServiceContainerAttributes) : ServiceWithPricing 
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GetMailingFees Method 


Description 
The method is used to get the Mailing Fee for a specified key. 


Syntax 
GetMailingFees(in mailingFeeRequest : MailingFeeRequest) : MailingFee 


GetZone Method 


Description 
The method is used to get the zone information between origination and destination ZIP codes. The 


similiar method with the shippingDateTime input parameter changes the behavior to produce results 
available as of the date specified. 


Syntax 
GetZone(in originZlPCode : ZipCode, in destinationZlPCode: ZipCode) : Zone 


GetZone(in originZlIPCode : ZipCode, in destinationZIPCode: ZipCode, in shippingDateTime : DateTime): 
Zone 


GetZones Method 


Description 

The method is used to get the zone information for a 3-digit ZIP Code. When the ZIP Code collection 
contains more than a single 3-digit ZIP Code, zone information is returned to each ZIP Code passed. The 
similiar method with the shipping DateTime input parameter changes the behavior to produce results 
available as of the date specified. 


Syntax 
GetZones(in zipCodes : ZipCodeCollection) : ZoneCollection 


GetZones(in zipCodes : ZipCodeCollection, in shippingDateTime : DateTime) : ZoneCollection 
Validate Method 


Description 
This method is used to validate the specified mail properties. The method will return origin and 
destination location objects. 


Syntax 
Validate(in servicesRequest : ServicesRequest) : LocationCollection 
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CalculationRequest Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Business. Entity 


Base Class 
ServicesRequest 


Properties 
Selections : CalculationSelections 
IsExtraServiceConversational : bool 


CalculatedPricing Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Business. Entity 


Base Class 
None 


Properties 

Geography: Geography 

Commitments : ServiceCommitmentCollection 
Restrictions : MailingRestrictionCollection 
Service : PostageService 

Annotations : AnnotationCollection 

Totals : PostagePriceCollection 

Effective: DateTime 


CalculationSelections Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Business. Entity 


Base Class 
None 


Properties 

MailServicelD : MailServicelD 
DeliveryOptionKey : string 
ExtraServices : ExtraServicelDCollection 
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ExtraServicesRequest Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Business. Entity 


Base Class 
None 


Properties 

IDCard : IDCard 

Weight : Weight 

ExcludeSections : ResultSectionCollection 

MailServicelD : MailServicelD 

ExtraServices: ExtraServicelDCollection 
ExtraServiceParameters: AdditionallnputValueCollection 
ShippingDateTime : DateTime 


ExtraServicesWithPricing Class 


Namespace 
ManTech.Usps.RateEngine.Domestic.Business.Entity 


Base Class 
None 


Properties 

ExtraServices: ExtraPostageServiceCollection 
Annotations : AnnotationCollection 

Effective: DateTime 


Geography Class 


Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


Base Class 
None 


Properties 
DestinationCity : string 
DestinationState : string 
DestinationIsAPO : bool 
OriginCity : string 
OriginState : string 
OriginlsAPO : bool 

Zone: int 


USPS Pricing Engine .NET SDK version 11.10.2.0 


Page 15 of 66 





IsLocal : bool 
CommonNDC : bool 


MailingFee Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 


Properties 

Cost : decimal 

FeeKey : string 

Price : decimal 

ValueKey : string 
ValueKeyLowerLimit : decimal 
ValueKeyUpperLimit : decimal 
Effective: DateTime 


MailingFeeCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
List<MailingFee > 


Properties 
None 


MailingFeeRequest Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 


Properties 

IDCard: IDCard 

FeeKeys : FeeKeyCollection 
QueryValue : decimal 
ShippingDateTime: DateTime 
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MailingFeeRequest .FeeKey Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 


Properties 
Value : string 


MailingFeeRequest .FeeKeyCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
List<MailingFeeRequest .FeeKey> 


Properties 
None 


MailPieceAttributes Class 


Namespace 
Man Tech. Usps. RateEngine.Domestic.Business. Entity 


Base Class 
None 


Properties 

Origin : LocationAttributes 

Destination : LocationAttributes 
ShippingDateTime : DateTime 

Dimensions : Dimensions 

Weight : Weight 

MailShapeAndSizes : MailShapeAndSizeCollection 
MailPieceContents : MailPieceContent Collection 
MailEntryPoint : DestinationEntry.EntryValue 
Sortation : string 


DestinationEntry.EntryValue Enumerator 
None 

DNDC 

DSCF 

DDU 
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MailPieceAttributes.LocationAttributes Class 


Namespace 
Man Tech. Usps. RateEngine.Domestic.Business. Entity 


Base Class 
None 


Properties 
ZIP: ZipCode 
IsPOBox : bool 


MailPieceContent Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
None 


Properties 
Key : string 


MailPieceContentCollection Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
List<MailPieceContent> 


Properties 
None 


ServicesRequest Class 


Namespace 
ManTech.Usps.RateEngine.Domestic.Business.Entity 


Base Class 
None 
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Properties 

IDCard: IDCard 

MailPieceAttributes: MailPieceAttributes 
ExcludeSections : ResultSectionCollection 
ExtraServiceParameters : AdditionallnputValueCollection 


ServiceWithPricing Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Business. Entity 


Base Class 
None 


Properties 

Geography : Geography 

Commitments : ServiceCommitmentCollection 
Restrictions : MailingRestrictionCollection 
Services : PostageServiceCollection 
Annotations : AnnotationCollection 

Effective: DateTime 


SKURequest Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 


Properties 

IDCard: IDCard 

SKU : string 
ShippingDateTime : DateTime 


SKUPrice Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 


Properties 
SKU : string 
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Price : decimal 
PostageStatementSection: string 
PostageStatementLine : int 


SKUPriceCollection Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
List <SKUPrice> 


Properties 
N/A 
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International Pricing Engine Interface 


The following operations are defined for the International Pricing Engine. See “Pricing Engine Design 
Model. pdf” for details. 


PostOffice Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business 


CalculateServicePrice 


Description 
This method is used to calculate the total cost of a selected mail service and any selected extra services. 


Syntax 
CalculateServicePrice(in request : CalculationRequest) : CalculatedPricing 


GetCountries 


Description 
This method is used to get the collection of countries. The similiar methods with the shippingDate input 
parameter changes the behavior to produce results available as of the date specified. 


Syntax 
GetCountries() : CountryCollection 


GetCountries(in shippingDate : DateTime) : CountryCollection 


GetCountries(in clientType : MailProperties.ClientType) : CountryCollection 


GetCountries(in clientType : MailProperties.ClientType, in shippingDate: DateTime): 
CountryCollectionGetCountryInformation 


Description 
This method is used to get the Country Information for a specific country. This includes the country 


price group, prices and other guidelines. The similiar methods with the shippingDate input parameter 
changes the behavior to produce results available as of the date specified. 


Syntax 
GetCountryInformation(in country : Country, in calculatorlD : CalculatorlD): Countrylnformation 


GetCountrylnformation(in country : Country) : Countrylnformation 


GetCountrylnformation(in country : Country, in shippingDate : DateTime): Countrylnformation 
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GetCountryRegulations 


Description 
This method is used to get the collection of Regulations for a specific country. The similiar methods with 


the shippingDate input parameter changes the behavior to produce results available as of the date 
specified. 


Syntax 
GetCountryRegulations(in country : Country) : CountryRegulationCollection 


GetCountryRegulations(in country : Country, in shippingDate : DateTime) : CountryRegulationCollection 


GetCountryRegulations(in country : Country, in clientType : MailProperties.ClientType) : 
CountryRegulationCollection 


GetCountryRegulations(in country : Country, in clientType : MailProperties.ClientType, in shippingDate : 
DateTime) : CountryRegulationCollection 


GetExtraServicesWithPricing 


Description 
This method is used to get a specified list of extra service with the price of each. 


Syntax 
GetExtraServicesWithPricing (in extraServicesRequest : ExtraServicesRequest) : ExtraServicesWithPricing 


GetServicesWithPricing 


Description 
This method is used to geta list of mailing services with associated extra services for the specified mail 


piece attributes. 


Syntax 
GetServicesWithPricing(in servicesRequest : ServicesRequest) : ServicesWithPricing 


GetMailingFees Method 


Description 
The method is used to get the Mailing Fee for a specified key. The Mailing Fee Request can contain a list 


of keys or a single key path with dots “.” delimiters. If the full key path is not specified the result will be 
in the form of a tree with the end of each brunch containing the price, cost, value key, and value limits. 
If the QueryValue is specified the results will be filtered using the value limits. If the value key of all the 
result mailing fee matches, the value is applied to calculate the Cost. 


Request Key Example: 
AddressCorrection.Electronic.FCM 


or 
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AddressCorrection 
Electronic 
FCM 


Query Value Example: 
Request: 


QueryValue = 10 

FeeKey = “StampedEnvelopes. PlainStampedEnvelopes. Basic.10.Each” 
Results: 

Price = 0.13 

Cost = 1.30 


Syntax 
GetMailingFees(in mailingFeeRequest : MailingFeeRequest) : MailingFee 


GetServiceCommitments Method 


Description 
This method is used to retrieve service commitments (delivery dates) for the available mail services 
based upon the request parameters supplied. 


Syntax 
GetServiceCommitments(in request : RequestProperties, inout serviceCommitment : 
ServiceCommitmentCollection) : void 


GetServiceCommitmentsStatesOrProvinces 


Description 
This method will return the states or provinces, within the specified country, supporting PMEI 
Guaranteed delivery. 


Syntax 
GetServiceCommitmentsStatesOrProvinces(in request : RequestProperties, inout 


expressMailGuaranteeditems : ExpressMailGuaranteedltemCollection) void 


GetServiceCommitmentCities 


Description 
This method will return the cities, within state or province and the specified country, supporting PMEI 
Guaranteed delivery. 


Syntax 
GetServiceCommitmentsCities(in request : RequestProperties, inout expressMailGuaranteeditems : 
ExpressMailGuaranteedltemCollection) void 
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GetServiceCommitmentsPostalCodes 


Description 
This method will return the postal code, representing the state or province within the specified country, 
supporting PMEI. 


Syntax 
GetServiceCommitmentsPostalCodes(in request : RequestProperties, inout 


expressMailGuaranteedltems : ExpressMailGuaranteedltemCollection) void 
GetPriceBySKU Method 


Description 
This method is used to get a collection of Prices for a specified SKU. The requested SKU can be a full 15 


digit SKU or a partial SKU. The requested SKU can also contain wildcard characters “%”. The result 
collection will contain all prices that match the requested SKU. Each node in the collection contains the 
SKU, Price, Postage Statement Section and Postage Statement Line. 


Syntax 
GetPriceBySKU(in priceBySKURequest : SKURequest) : SKUPriceCollection 


Validate 


Description 
This method is used to validate the specified mail properties. 


Syntax 
Validate(servicesRequest : ServicesRequest) : void 


ValidateCountry 


Description 
This method is used to discover if a specified country is valid. The similiar methods with the 


shippingDate input parameter changesthe behavior to produce results available as of the date 
specified. 


Syntax 
ValidateCountry(in countrylD : CountrylD) : void 


ValidateCountry(in countrylD : CountrylD, in shippingDate : DateTime) : void 


CalculatedPricing Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 
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Base Class 
None 


Properties 

Geography : Geography 

Commitments : ServiceCommitment Collection 
Service : PostageService 

Annotations : AnnotationCollection 

Totals : PostagePriceCollection 

Regulations: CountryRegulation 
GXGLocations : GXGLocationCollection 
Effective: DateTime 


CalculationRequest Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 


Base Class 
ServicesRequest 


Properties 
Selections : CalculationSelections 
IsExtraServiceConversational: bool 


CalculationSelections Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 


Base Class 
None 


Properties 

MailServicelD : MailServicelD 
DeliveryOptionKey : string 
ExtraServices: ExtraServicelDCollection 


Geography Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 


Base Class 
None 


USPS Pricing Engine .NET SDK version 11.10.2.0 


Page 25 of 66 





Properties 

ID : CountrylD 
Name: string 
Code : string 
Number : string 


ExtraServicesReguest Class 


Namespace 
ManTech.Usps.RateEngine.lnternational. Business. Entity 


Base Class 
None 


Properties 

IDCard: IDCard 

Weight : Weight 

ExcludeSections : ResultSectionCollection 

MailServicelD : MailServicelD 

ExtraServices: ExtraServicelDCollection 
ExtraServiceParameters : AdditionallnputValueCollection 
ShippingDateTime : DateTime 


ExtraServicesWithPricing Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 


Base Class 
None 


Properties 

ExtraServices: ExtraPostageServiceCollection 
Annotations : AnnotationCollection 

Effective: DateTime 


MailingFee Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 
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Properties 

Cost : decimal 

FeeKey : string 

Price : decimal 

ValueKey : string 
ValueKeyLowerLimit : decimal 
ValueKeyUpperLimit : decimal 
Effective : DateTime 


MailingFeeCollection Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
List<MailingFee > 


Properties 
None 


MailingFeeRequest Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
None 


Properties 

IDCard : IDCard 

FeeKeys : FeeKeyCollection 
QueryValue : decimal 
ShippingDateTime: DateTime 


MailingFeeRequest .FeeKey Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
None 


Properties 
Value : string 
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MailingFeeRequest .FeeKeyCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
List<MailingFeeRequest .FeeKey> 


Properties 
None 


MailPieceAttributes Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 


Base Class 
None 


Properties 

Origin : LocationAttributes 

Destination : LocationAttributes 
ShippingDateTime : DateTime 

Dimensions : Dimensions 

Weight : Weight 

MailShapeAndSizes : MailShapeAndSizeCollection 
MailPieceContents : MailPieceContent Collection 


MailPieceAttributes.LocationAttributes Class 


Namespace 
ManTech.Usps.RateEngine.International. Business. Entity 


Base Class 
None 


Properties 

CountrylD : CountrylD 
CountryName : string 
CountryCode : string 
CountryNumber : string 
PostalCode : string 
IsPOBox : bool 
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ServicesRequest Class 


Namespace 
Man Tech. Usps. RateEngine.International. Business. Entity 


Base Class 
None 


Properties 

IDCard: IDCard 

MailPieceAttributes: MailPieceAttributes 
ExcludeSections : ResultSectionCollection 
ExtraServiceParameters : AdditionallnputValueCollection 


ServicesWithPricing Class 


Namespace 
Man Tech. Usps. RateEngine.|International. Business. Entity 


Base Class 
None 


Properties 

Geography : Geography 

Commitments : ServiceCommitmentCollection 
Services : PostageServiceCollection 
Regulations: CountryRegulation 
GXGLocations : GXGLocationCollection 
Annotations : AnnotationCollection 

Errors : PricingEngineErrorCollection 
Effective: DateTime 


SKURequest Class 


Namespace 
ManTech.Usps.RateEngine.Business.Entity 


Base Class 
None 


Properties 

IDCard : IDCard 

SKU : string 
ShippingDateTime : DateTime 
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SKUPrice Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
None 


Properties 

SKU : string 

Price : decimal 
PostageStatementSection: string 
PostageStatementLine: int 


SKUPriceCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Business. Entity 


Base Class 
List <SKUPrice> 


Properties 
N/A 
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Rate Engine Framework 


AdditionalInputValue 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 


TypelD: string 
EnteredValue : decimal 


AdditionalInputValueCollection 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<AdditionallnputValue> 


Properties 
None 


Annotation Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 


Text: string 
Associations : AssociationCollection 


Annotation.AssociationCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<int> 
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Properties 
None 


AnnotationCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<Annotation> 


Properties 
None 


Country Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
None 


Properties 

CountrylD : CountrylD 
Name: string 
NameParts: string[] 
Code : string 
CountryNumber : string 
TypeOf : short 

Status : CountryStatus 
IsDisplayed : bool 
ShowOnlinePrice : bool 
MaxWeight : Weight 
IsParent : bool 

Aka : CountryAliasCollection 


Country.Status Enumerator 
Unknown 

Normal 

NoOnlineService 
ServiceSuspended 
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CountryAlias Class 


Namespace 
Man tech. Usps. RateEngine.International. Entity 


Base Class 
None 


Properties 
Alias : string 


CountryAliasCollection Class 


Namespace 
ManTech.Usps.RateEngine.International. Entity 


Base Class 
List<CountryAlias> 


Properties 
None 


CountryCollection Class 


Namespace 
Man Tech. Usps. RateEngine.|International. Entity 


Base Class 
List<Country> 


Properties 
None 


CountryID Structure 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
None 


Properties 
Value : int 
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CountryInformation Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
List<Countrylnformationltem> 


Properties 
None 


CountryInformationltem Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
None 


Properties 

CountryToMailService : CountryToMailService 
CountryToExtraServices : CountryToExtraServiceCollection 
Price : decimal 

OnlinePrice : decimal 

CommercialPlusPrice : decimal 


CountryRegulation Class 


Namespace 
Man Tech. Usps. RateEngine.|International. Entity 


Base Class 
None 


Properties 

Country : Country 

Prohibitions : string 
Restrictions : string 
Observations : string 
CustomsForms : string 
ExpressMailRegulations: string 
ExpressMailNote : string 
AdditionalRestrictions : string 
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CountryRegulationCollection Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
List<CountryRegulation> 


Properties 
None 


CountryToMailService Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
None 


Properties 

ServiceTitle : string 

MailServicelD : MailServicelD 

IsAvailable : bool 

WeightLimit : Weight 

WeightLimitOperator : Weight. WeightOperator 
weightMin: Weight 

WeightMinOperator : Weight.WeightOperator 
InsuranceMax : decimal 

PriceGroups : PriceGroupCollection 
EstimatedDeliveryTime : string 
DimensionalRange : DimensionalRange 


CountryToExtraService Class 


Namespace 
ManTech.Usps.RateEngine.International. Entity 


Base Class 
None 


Properties 

ServiceTitle : string 
ExtraServicelD : ExtraServicelD 
IsAvailable : bool 

Price : decimal 

OnlinePrice : decimal 


USPS Pricing Engine .NET SDK version 11.10.2.0 


Page 35 of 66 





CountryToExtraServiceCollection Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
List<CountryToExtraService> 


Properties 
None 


Dimensions Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 

Length: Dimension 

Width : Dimension 

Height : Dimension 

Girth : Dimension 

IsRectangular: bool 
RoundDownToQuarterInch: bool 


DimensionalRange Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
None 


Properties 

MaxLength : Dimension 
MaxWidth : Dimension 
MaxHeight : Dimension 
MaxLengthPlusGirth : Dimension 
MaxLWH : Dimension 
MinLength : Dimension 
MinWidth : Dimension 
MinHeight : Dimension 
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MinThickness : Dimension 
Text : string 
AdditionalSizes : DimensionalRangeCollection 


ExtraP ostageService Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 

ID: ExtraServicelD 

Name: string 

GroupCode : string 

Prices : PostagePriceCollection 
AdditionalFields : AdditionallnputCollection 
Attributes: PostageAttributeCollection 


ExtraPostageService.AdditionalInput Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 
Key : string 
Min : decimal 
Max: decimal 


ExtraP ostageService.AdditionalInputCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<ExtraPostageService. Additionallnput > 


Properties 
None 
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ExtraPostageServiceCollection Class 


Namespace 
Man Tech. Usps.RateEngine.Entity 


Base Class 
List<ExtraPostageService> 


Properties 
None 


ExtraServicelD Structure 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
None 


Properties 
Value : int 


ExtraServicelD Collection Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
List<ExtraServicelD> 


Properties 
None 


GXGLocation Class 


Namespace 
ManTech.Usps.RateEngine.International. Entity 


Base Class 
None 


Properties 
LocationName: string 
Street : string 

City : string 
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State: string 

ZipCode ZipCode : 
WeekdayCut Off : string 
SaturdayCutOff : string 


GXGLocationCollection Class 


Namespace 
ManTech.Usps.RateEngine.International. Entity 


Base Class 
List<GXGLocation> 


Properties 
None 


IDCard Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
None 


Properties 

CallerlD : string 
SourcelD : string 
CustomerType : string 


Location Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
None 


Properties 

ZipCode : ZipCode 

City : string 

State : string 
FinanceCode : string 
IsApo : bool 
ClassificationCode : string 
IsValid : bool 
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IsMailable : bool 
IsHoldForPickupAvailable : bool 
IsSundayHolidayAvailable : bool 
NonDeliveryDays : List<DayOfWeek> 
PremiumDays: List<DayOfWeek> 
LocationType : TypeOfLocation 
IsPOBox : bool 


TypeOfLocation Enumerator 
Origination 

Destination 

Neither 


LocationCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Domestic.Entity 


Base Class 
List<Location> 


Properties 
None 


MailingRestriction Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
None 


Properties 
ZipCode : ZipCode 
Restrictions : RestrictionCollection 


MailingRestriction.Restriction Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
None 
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Properties 
Code : string 
Description : string 


MailingRestriction.RestrictionCollection Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
List< MailingRestriction. Restriction> 


Properties 
None 


MailingRestrictionCollection Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
List<MailingRestriction> 


Properties 
None 


MailServiceID Structure 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 
Value : short 


MailShapeAndSizeEnum Enumerator 
Unknown 

Letter 

LetterLarge 

Package 

Postcard 

FlatRateBox 
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FlatRate 
ExpressMailServices 
PriorityMailServices 
FirstClassMailServices 
PostalServices 
FlatRateEnvelope 


MailShapeAndSizeCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<MailShapeAndSize> 


Properties 
None 


PostageAttribute 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
None 


Properties 


Key : string 
Value : string 


PostageAttributeCollection 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
List<PostageAttribute> 


Properties 
None 
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PriceDetail Class 


Namespace 
Man Tech. Usps.RateEngine.Entity 


Base Class 
None 


Properties 
Key : string 
Value : string 


PriceDetailCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<PriceDetail> 


Properties 
None 


PriceGroup Class 


Namespace 
Man Tech. Usps. RateEngine.Interational. Entity 


Base Class 
None 


Properties 
Key : string 
Value : string 


PriceGroupCollection Class 


Namespace 
Man Tech. Usps. RateEngine.International. Entity 


Base Class 
List<PriceGroup> 


Properties 
None 
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PostagePrice Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 

Amount : decimal 

Type : string 

Details : PriceDetailCollection 


PostagePriceCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<PostagePrice> 


Properties 
None 


PostageService Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 

ID: MailServicelD 

Name: string 

DeliveryOptions : DeliveryOptionCollection 
GroupCode : string 

MaxWeight : Weight 

MinWeight : Weight 

DimensionalRange : DimensionalRange 
ExtraServices : ExtraPostageServiceCollection 
Attributes: PostageAttributeCollection 


USPS Pricing Engine .NET SDK version 11.10.2.0 Page 44 of 66 





PostageService.DeliveryOption Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 

Key : string 

Commitment : string 

Name: string 

Prices : PostagePriceCollection 


PostageService.DeliveryOptionCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
List<PostageService. DeliveryOption> 


Properties 
None 


ResultSection Class 


Namespace 
Man Tech. Usps. RateEngine.Entity 


Base Class 
None 


Properties 
Key : ResultSection.SectionType 


ResultSection.SectionType Enumerator 
UnknownCountryRegulations 
DimensionalRange 

ExtraServices 

Geography 

GXGLocations 

PriceDetails 
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Restrictions 
ServiceCommitments 
Annotations 
Breadcrumb 
RelatedLinks 

HelpLinks 

Notes 

Footnotes 
ServiceCommitmentCall 


ResultSectionCollection Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
List<ResultSection> 


Properties 
None 


Weight Class 


Namespace 
ManTech.Usps.RateEngine.Entity 


Base Class 
None 


Properties 
Ounces : decimal 
Pounds : decimal 
Units : WeightUnit 


Weight.WeightUnit Enumerator 
Unknown 

Ounces 

Pounds 


ZipCode Structure 


Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


USPS Pricing Engine .NET SDK version 11.10.2.0 Page 46 of 66 





Base Class 
None 


Properties 
Value : string 


ZipCodeCollection Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
List<ZipCode> 


Properties 
None 


Zone Class 


Namespace 
Man Tech. Usps.RateEngine.Domestic.Entity 


Base Class 
None 


Properties 

OriginZipCode : ZipCode 
DestinationZipCode : ZipCode 
ZoneCount : int 

IsintraBMC: bool 

IsLocal : bool 

Has5DigitZones: bool 

Zone5DigitZones : Zone5DigitCollection 


Zone. Zone5Digit Class 


Namespace 
Man Tech. Usps. RateEngine.Domestic.Entity 


Base Class 
None 


Properties 


OrigZIPFirst : ZipCode 
OrigZIPLast : ZipCode 


USPS Pricing Engine .NET SDK version 11.10.2.0 Page 47 of 66 





DestZIPFirst : ZipCode 
DestZIPLast : ZipCode 
ZoneCount : int 


Zone. Zone5DigitCollection Class 


Namespace 
Man Tech. Usps. RateEngine.Domestic.Entity 


Base Class 
List<Zone. Zone5Digit> 


Properties 
None 


ZoneCollection Class 


Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


Base Class 
List<Zone> 


Properties 
None 
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Service Delivery Extensions 


DOMESTIC NAMESPACE 
OnlineServiceCommitment Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. Domestic. Entity 


Base Class 
ServiceCommitment 


Properties 

EstimatedDeliveryTime : string 

DeliveryDateTime : DateTime 

IsHoliday : bool 

CommitmentName; string 

CommitmentTime : string 

CommitmentSequence : string 

locations : ServiceCommitment.PostalLocationCollection 
holdForPickupLocations : ServiceCommitment. PostalLocationCollection 


ServiceCommitment Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. Domestic. Entity 


Base Class 
None 


Properties 

ServiceCommitmentType : Type 

Product : string 

ErrorNumber: int 

ErrorMessage : string 
ServiceCommitmentGuarantee : Guarantee 
UsedByMailService : MailServicelDCollection 


ServiceCommitment.Guarantee Enumerator 
Unknown 

NoGuarantee 

MoneyBackGuarantee 

LossOnlyGuarantee 
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ServiceCommitment.Type Enumerator 
Unknown = 0 

ExpressMail 

PriorityMail 

FirstClassMail 

StandardMail 

Periodicals 

PackageServices 


ServiceCommitment.PostalLocation Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. Domestic. Entity 


Base Class 
None 


Properties 

CutOff : string 
Facility : string 
Facility! D : string 
Street: string 

City : string 

State : string 
ZipCode : string 
ZipCode4 : string 
ScheduledDeliveryDate : DateTime 
closeTimes : string[] 


ServiceCommitment.P ostalLocationCollection Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. Domestic. Entity 


Base Class 
List<ServiceCommitment. PostalLocation> 


Properties 
None 


ServiceCommitmentCollection Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. Domestic. Entity 
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Base Class 
List<ServiceCommitment> 


Properties 
None 


INTERNATIONAL NAMESPACE 


ExpressMailGuaranteed Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. International. Entity 


Base Class 
ServiceCommitment 


Properties 
None 


ServiceCommitment Class 


Namespace 
Usps. RateEngine. ServiceDeliveryExtensions. International. Entity 


Base Class 
None 


Properties 

Type : ServiceCommitmentType 
ErrorNumber: int 

ErrorMessage: string 

DeliveryDate: string 

City : string 

StateOrProvince : string 

ShippingDate : DateTime 

ShippingTime : string 

UsedByMailService : MailServicelD Collection 


ServiceCommitmentCollection Class 


Namespace 
Usps.RateEngine.ServiceDeliveryExtensions. International. Entity 


Base Class 
List<ServiceCommitment> 


USPS Pricing Engine .NET SDK version 11.10.2.0 


Page 51 of 66 





Properties 
None 
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Customs Forms Engine 


GetCustomsForms Method 


Description 
This method returns the Customs Forms hierarchy tree for the specified properties. 


Syntax 
GetCustomsForms(in customsFormsMailProperties : CustomsFormsMailProperties) : 
CustomsFormCollection 


GetCustomsFormsPage Method 


Description 
This method returns the Customs Forms hierarchytree, a list of available mail services and footnotes for 
the specified properties. 


Syntax 
GetCustomsFormsPage(in customsFormsMailProperties : CustomsFormsMailProperties) : 
CustomsFormsPage 


GetCustomsFormsSubPage Method 


Description 
This method returns the Customs Forms hierarchy tree and footnotes for the specified properties. 


Syntax 
GetCustomsFormsSubPage(in customsFormsMailProperties : CustomsFormsMailProperties) : 
CustomsFormsPage 


Validate Method 


Description 
This method returns True or False if a Customs Form is needed for the specified properties. 


Syntax 
Validate(in customsFormsMailProperties : CustomsFormsMailProperties) : void 


CustomsFormsCalculator Class 


Namespace 
ManTech.Usps.RateEngine.CustomsForms 


Base Class 
None 
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CustomsFormCollection Class 


Namespace 
Man Tech. Usps.RateEngine.CustomsForms. Entity 


Base Class 
List<CustomsForm> 


Properties 
None 


CustomsForm Class 


Namespace 
Man Tech. Usps. RateEngine.CustomsForms. Entity 


Base Class 
None 


Properties 

FormName : TextWithLinks 

Condition : TextWithLinks 

Notes : TextWithLinks 

ChildCustomsForms : CustomsFormCollection 


CustomsFormMailProperties Class 


Namespace 
Man Tech. Usps. RateEngine.CustomsForms. Entity 


Base Class 
None 


Properties 

IsDocument : bool? 
IsPotentiallyDutiable: bool? 
IsGreaterThen3_4Thick : bool? 
IsUniformlyThick : bool? 
CountrylD : CountrylD 
OrginZipCode : ZipCode 
DestinationZipCode : ZipCode 
IDCard : IDCard 

ShippingDate : DateTime 
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CustomsFormsPage Class 


Namespace 
Man Tech. Usps.RateEngine.CustomsForms. Entity 


Base Class 
None 


Properties 

MailServices : MailServiceCollection 

Country : Country 

CustomsFormsMailProperties : CustomsFormsMailProperties 
AreZ|PCodeRequired : bool 

CustomsForms : CustomsFormCollection 

Footnotes : TextWithLinksCollection 
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Appendix 


Customer Type Codes 
See “Client IDs and Customer Types. pdf” be complete details. 
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Group Code Description 


Mail Service Group Codes 
Index Field Name Code Description 


Service D | Domestie = ———————_— 
International 


Mail Type 
CATE 
ECOMPRO 
[B | Bound Printed Matter | 
R | 
o | 
D | 
Q | 


Parcel Return Service 
Parcel Select 


Parcel Select Lightweight 

PMOD 

EDDM 
AA 


None 


Flat Rate 


Sub Type 
JR _  [RegionalRate "| 
|B |Nonautomation____________________ | 
[QT AutomationDisc O] 


D | Carrier Route NonAutomation SSS 
I [egar SSCS 
P [Peste č žăž OŠ O 
V | Nompresorted — č č  žăŽ O=O o 
u able 
Shape one 
B Bo 2 
"PT Parcelor Package č ăć O=ăŽ Ož 
[Shape Sub [0| Shape sub version 0 tonumberof — — 
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Delivery Type 
Delivery Time 
pPofẹm SSS 


Extra Service Group Codes 
Index Field Name Code Description 

= Service JD” | Domestic S O 
[I [International S |] 
1 [Type ES 
Extra Service Type 
[I | Insuane O 
PR Return Recept O= ă OSOS Š Š SSS 
[D___| Certificate of Mailing 
[J |RestrictedDelivery________________ñú] 
[H_ |SpecialHandling_______________ñ—|] 
[A | Adult Signature Required ___ _ č | 
[B | Adult Signature Restricted Delivery_____________ | 
M 10:30 Delivery] 
[L  |ParcelAidift S O 
[Z | Sunday/Holiday Delivey 
[K_ | Picture PermitImprint i | 
[U | USPS Delivery Confirmation __ č č | 
X oe SSS 
[E |Priority Mail Express—________________ | 
[P| PriorityMail | 
ee Jie = se A 
LO... | Variation version 0 to number of | 
[x  |None S O 


Associated Mail 
Type 


Sub Type 


+ [Vanation | 
6 | 
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Attribute Keys 


Domestic 
| Key | Description 


MailEntry The Mail Entrytype 


DimensionalWeightR The Dimensional Weight. Returned when the Dimensional Weight is used in 
katran the calculation of the Retail Price. 

DimensionalWeightCB The Dimensional Weight. Returned when the Dimensional Weight is used in 
Piven the calculation of the Commercial Base Price. 

DimensionalWeightCP The Dimensional Weight. Returned when the Dimensional Weight is used in 
Cen | the calculation of the Commercial Plus Price. 

DimensionalWeightNA The Dimensional Weight. Returned when the Dimensional Weight is used in 
Matan the calculation of the Price and the Price Type is Not Applicable. 

International 
| Key Description 


Includedindemnity The included Insurance Indemnity for the mail service / weight. 
DeclaredValueSDR The value with the Special Drawing Right applied to the declare value. 


InclnceNonnegotiableDoc | The Included Insurance amount when the mail piece contains only 
Nonnegotiable Document(s). 


InclnceMerchandise The Included Insurance amount when the mail piece contains Merchandise. 


ECOMPRO Set to True or False to indicate that Priority Mail International mail service is 
or is not ECOMPRO. 

Ip_type Indicator if the block information is for a Logistics Partner or Post. 
See the Web Service UPUXIT SDC Spec 

The Logistics Partner code that will support international transportation. 

lp_barcodetype The barcode(s) that a Logistics Partner will support for international 
transportation. A commas delimited list of Barcodes. 
i.e. S10,W12 
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Content Keys 


Domestic 
| Key Description 
LiveAnimals The mail piece content is a Live Animal(s). 
Equivalent to Special Handling - Live Animal Transportation 


Equivalent to Special Handling - Hazardous Material Transportation 


The mail piece content is Cremated Remains 
Perishables The mail piece content is Perishable. 

Fragile The mail piece content is Fragile 

fee egal to speca ndings Fagle U 


MedicalSupplies The mail piece contains medical supplies 
Pharmaceuticals The mail piece contains pharmaceutical supplies 


Note: Content Keys are subject to change. 


International 
Description 


Key 


Note: Content Keys are subject to change. 


Price Detail Keys 


Domestic 


| Description 
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International 


| Key | Description 


Nonmachinable Fee 


Price Group Keys 


International 


| Description 


Retail Price 
Commercial Base Price 
Commercial Plus Price 


NSA 1 Price 


NSA 2 Price 


The Price Group Keys matches the SKU definition for Price Types. 
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Sortation Keys 


Domestic 
| Key | Description 
5-Digit 
3-Digit 


Q| w 
oj U 

UJ 

i) 

un; 


Carrier Route 


UN 
Un 


SS Scheme Container 
FSS Facility Container 


Un 
O 
== 


Y | UT 
DI 
T Nn 
Ti 


EMM Tray Box 

Full Tray Box 

alf Tray Box 

lat Tub Tray Box 

Presort 

Any mixed mailing 

Note: Sortation Keys will be extended as new sortation’s are supported 


ive] 
L 


v| 2 n 
O Wn 
U n 


=| 
UJ 
— 
n 


A 
+ 
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Code Examples 


Domestic Pricing Engine 
GETSERVICEWITH PRICING 


ServicesRequest request = new ServicesRequest(); 


Il id card 

request.IDCard.CallerID = "14"; 
request.IDCard.SourcelD = "8"; 
request.IDCard.CustomerType = "008B3"; 


// mail piece attributes 
request.MailPieceAttributes. MailShapeAndSize = MailShapeAndSize Enum. Pac kage; 
request.MailPieceAttributes. ShippingDateTime = new DateTime(2014, 5, 12, 8, 0, 0); 


If set ZIP codes 

request.MailPieceAttributes. Origin.ZIP = new ZipCode("43338"); 
request.MailPieceAttributes. Destination.ZIP = new ZipCode("20603"); 
request.MailPieceAttributes.Destination.Is POBox = false; 


// defaults to Unknown, set as an example 
request.MailPieceAttributes. MailEntryPoint = DestinationEntry.EntryV alue. Unknow n; 


If set weight 
request.MailPieceAttributes. Weight = new Weight(1,0); 


// dimensions, default is rectangular, L =0,H=0,W=0,G=0 
request.MailPieceAttributes. Dimensions. Is Rectangular = true; 
request.MailPieceAttributes. Dimensions.Length = 12.0M; 
request.MailPieceAttributes. Dimensions.Height = 5.0M; 
request.MailPieceAttributes. Dimensions.Width = 4.0M; 
request.MailPieceAttributes. Dimensions.Girth = 0.0M; 


// Content values 

request.MailPieceAttributes. MailPiece Contents. Clear(); 
request.MailPieceAttributes. MailPiece Contents.Add(new MailPieceContent() { Key ="LiveAnimals" }); 
request.MailPieceAttributes. MailPiece Contents.Add(new MailPieceContent() { Key ="Nonmachinable" }); 


If exclude sections 
request.ExcludeSections.Clear(); 


request.ExcludeSections.Add(new ResultSection() {Key = ResultSection.Section Type. DimensionalRange 


ServicesWithPricing services_with_pricing = new PostOffice().GetServicesWithPricing(req uest); 
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CALCULATESERVICEP RICE 
CalculationRequest request = new CalculationRequest(); 


If selections 

request.Selections.MailServicelD = new MailServicelD(2); 
request.Selections.DeliveryOptionKey = “XP”; 
request.Selections.ExtraServices.Add(new ExtraServicelD(101)); 
request.ExtraServiceParameters.Add(new AdditionallnputValue(“dvi’, “4000”)); 


Il id card 

reguest.IDCard. CallerID_= "14"; 
request.IDCard.SourcelD = "8"; 
request.IDCard.CustomerType = "008B3"; 


// mail piece attributes 
request.MailPieceAttributes. MailShapeAndSize = MailShapeAndSize Enum. Package; 
request.MailPieceAttributes. ShippingDateTime = new DateTime(2014, 5, 12, 8, 0, 0); 


İl set ZIP codes 

request.MailPieceAttributes. Origin.ZIP = new ZipCode("43338"); 
request.MailPieceAttributes. Destination.ZIP = new ZipCode("20603"); 
request.MailPieceAttributes. Destination. Is POBox = false; 

// defaults to Unknown, set as an example 

request.MailPieceAttributes. MailEntryPoint = DestinationEntry.EntryV alue. Unknow n; 


If set weight 
request.MailPieceAttributes. Weight = new Weight(1,0); 


// dimensions, default is rectangular, L =0,H=0,W=0,G=0 
request.MailPieceAttributes. Dimensions. ls Rectangular = true; 
request.MailPieceAttributes. Dimensions.Length = 12.0M; 
request.MailPieceAttributes. Dimensions.Height = 5.0M; 
request.MailPieceAttributes. Dimensions.Width = 4.0M; 
request.MailPieceAttributes. Dimensions.Girth = 0.0M; 


// Content values 

request.MailPieceAttributes. Mail Piece Contents. Clear(); 
request.MailPieceAttributes. MailPiece Contents.Add(new MailPieceContent() { Key ="LiveAnimals" }); 
request.MailPieceAttributes. MailPiece Contents.Add(new MailPieceContent() { Key ="Nonmachinable" }); 


// exclude sections 
request.ExcludeSections.Clear(); 


request.ExcludeSections.Add(new ResultSection() {Key = ResultSection.Section Type. DimensionalRange 


CalculatedPricing calculated_pricing = new PostOffice().CalculateServicePrice (request); 
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International Pricing Engine 


GET SERVICEWITH PRICING 
ServicesRequest request = new ServicesRequest(); 


Il id card 

request.IDCard.CallerID = "14"; 
request.IDCard.SourcelD = "8"; 
request.IDCard.CustomerType = "008B3"; 


// mail piece attributes 
request.MailPieceAttributes. MailShapeAndSize = MailShapeAndSize Enum. Package; 
request.MailPieceAttributes. ShippingDateTime = new DateTime(2014, 5, 12, 8, 0, 0); 


If set origin zip code and Country 
request.MailPieceAttributes. Origin. PostalCode = “43338”; 
request.MailPieceAttributes. Destination. Country ID = new CountryID( 12000); 


If set weight 
request.MailPieceAttributes. Weight = new Weight(1,0); 


// dimensions, default is rectangular, L =0,H=0,W=0,G=0 
request.MailPieceAttributes. Dimensions. Is Rectangular = true; 
request.MailPieceAttributes. Dimensions.Length = 12.0M; 
request.MailPieceAttributes. Dimensions.Height = 5.0M; 
request.MailPieceAttributes. Dimensions.Width = 4.0M; 
request.MailPieceAttributes. Dimensions.Girth = 0.0M; 


If Content values 

request.MailPieceAttributes. MailPiece Contents. Clear(); 

request.MailPieceAttributes. MailPieceContents.Add(new MailPieceContent() { Key ="Nonmachinable" }); 
I! exclude sections 

request.ExcludeSections .Clear(); 


request.ExcludeSections.Add(new ResultSection() {Key = ResultSection.Section Type. DimensionalRange 


ServicesWithPricing services_with_pricing = new PostOffice().GetServicesWithPricing(req uest); 
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CALCULATESERVICEP RICE 
CalculationRequest request = new CalculationRequest(); 


If selections 

request.Selections.MailServicelD = new MailServicelD(1); 
request.Selections.DeliveryOptionKey = “XX”; 
request.Selections.ExtraServices.Add(new ExtraServicelD(107)); 
request.ExtraServiceParameters.Add(new AdditionallnputValue(“dvi’, “4000”)); 


Il id card 

request.IDCard.CallerID = "14"; 
request.IDCard.SourcelD = "8"; 
request.IDCard.CustomerType = "008B3"; 


// mail piece attributes 
request.MailPieceAttributes. MailShapeAndSize = MailShapeAndSize Enum. Package; 
request.MailPieceAttributes. ShippingDateTime = new DateTime(2014, 5, 12, 8, 0, 0); 


If set origin zip code and Country 
request.MailPieceAttributes. Origin. PostalCode = “43338”; 
request.MailPieceAttributes. Destination. Country ID = new CountryID( 12000); 


If set weight 
request.MailPieceAttributes. Weight = new Weight(1,0); 


If dimensions, default is rectangular, L =0, H=0,W=0,G=0 
request.MailPieceAttributes. Dimensions. Is Rectangular = true; 
request.MailPieceAttributes. Dimensions.Length = 12.0M; 
request.MailPieceAttributes. Dimensions.Height = 5.0M; 
request.MailPieceAttributes. Dimensions.Width = 4.0M; 
request.MailPieceAttributes. Dimensions.Girth = 0.0M; 


// Content values 

request.MailPieceAttributes. Mail Piece Contents. Clear(); 
request.MailPieceAttributes. MailPiece Contents.Add(new MailPieceContent() { Key ="LiveAnimals" }); 
request.MailPieceAttributes. MailPieceContents.Add(new MailPieceContent() { Key ="Nonmachinable" }); 


If exclude sections 
request.ExcludeSections.Clear(); 


request.ExcludeSections.Add(new ResultSection() {Key = ResultSection.Section Type. DimensionalRange 


CalculatedPricing calculated_pricing = new PostOffice().CalculateServicePrice (request); 
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